dxp-ux

(0 reviews)

Get BillingAccountByServiceById

billingAccount/service/{id}

[GET]

This operation gets the account details based on service number for resources with operations that allow fetching of Account Details

URL

https://[localhost]:[port]/dxp-ux/v1/{businessId}/billingAccount/service/{id}

URL PARAMS

nametypedescriptionrequired
businessIdstring2 letter ISO 3166 country code (TT, BB, JM, PA, PR etc.) identifying the business unit.
Expected one is "PR"-Puerto Rico
Y
idstringcustomer phone numberY
nametypedescriptionrequired
client_idstringThe client_id identifying the channel.Y
client_secretstringPassword associated with the client_id.Y
X-Correlation-IDstringAn identifier for the current call chain that can be used to tie together log entries on multiple layers (e.g. client, server, mainframe). This identifier must be designed to be unique across all applications.
Note - Mule default behavior creates a sample x-correlation-id field if value is not passed from client, API will use this value in case value is not passed in API request
N
It is mandatory for Business
channelIdstringExpected value 'APP'Y
lobenumThe Line of Business Identifier currently available are:
FIXED
PREPAID
POSTPAID
N
Response [ 200 ]
LCPR Success Response

This is non-tmf response, which is used to retrieve the migration status from DynamoDB.

OK - request processed successfully, response body contains an entity corresponding to the requested resource.

{
  "subscriptionId": "165682573434",
  "accountType": "B2C",
  "state": "Active",
  "recurringFlag": false,
  "fraudFlag": false,
  "pin": "3472163402",
  "migrationStatus": "success",
  "salesforceAccountNumber": "169338844735",
  "migrationETA": "testing",
  "bssSourceSystem": "Anatares"
}

Possible response error

HTTP Status response is 400

with Response

[ 400 ]

Bad Request - the request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.

{
    "errors": [
        {
            "code": 400,
            "message": "APIKIT:BAD_REQUEST",
            "description": "Invalid value 'M' for uri parameter businessId. M is not a valid enum value"
        }
    ]
}
[ 401 ]

Unauthorized - The request has not been applied because it lacks valid authentication credentials for the target resource.

{
  "errors" : [{
      "code" : 401,
      "message" : "The user could not be authenticated for this request.",
      "description" : "The request has not been applied because it lacks valid authentication credentials for the target resource"
    }]
}
[ 403 ]

Forbidden - Indicates that the server understood the request but refuses to fulfill it. If authentication credentials were provided in the request, the server considers them insufficient to grant access. The client SHOULD NOT automatically repeat the request with the same credentials. The client MAY repeat the request with new or different credentials.

[ 404 ]

Not Found - server has not found a resource with that URI. This may be temporary and permanent condition. This status code is commonly used when the server does not wish to reveal exactly why the request has been refused, or when no other response is applicable.

{
    "errors": [
        {
            "code": 404,
            "message": "DYNAMO_DB :Account details not found for serviceNumber: 7872000007",
            "description": "NOACCTSFOUND-No Accounts found"
        }
    ]
}
[ 405 ]

Method Not Allowed - HTTP method not allowed for this resource. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI.

{
    "errors": [
        {
            "code": 405,
            "message": "APIKIT:METHOD_NOT_ALLOWED",
            "description": "HTTP Method post not allowed for : /{businessId}/billingAccount/service/{id}"
        }
    ]
}
[ 500 ]

Internal Server Error - server encountered an error processing request. This should not happen normally, but it is a generic error message, given when no more specific message is suitable.

{
"errors" : [{
"code" : 500,
"message" : "The request failed due to an internal error.",
"description": "error description"
}]
}
[ 501 ]

Check for the other BU Flows, if not implemented then throw a standard error message as below.

{
    "errors": [
        {
            "code": 501,
            "message": "NOT IMPLEMENTED",
            "description": "Operation GET /billingAccount/service/id for Business Id: JM not implemented"
        }
    ]
}
[ 503 ]

Service Unavailable

    {
    "errors": [
        {
            "code": 503,
            "message": "HTTP:SERVICE_UNAVAILABLE",
            "description": "HTTP POST on resource 'http://0.0.0.0:9091/nontmf-biz/v1/{businessId}/customerMigrationInfo?serviceNumber' failed: service unavailable (503)."
        }
    ]
}
Definitions
TMF 666
nametypedescriptionrequired
idstringUnique identifier of the accountN
hrefstringUnique reference of the accountN
accountTypestringA categorization of an account, such as individual, joint, and so forth, whose instances share some of the same characteristics. Note: for flexibility we use a String here but an implementation may use an enumeration with a limited list of valid valuesN
descriptionstringDetailed description of the party accountN
lastModifieddatetimeDate of last modification of the accountN
namestringName of the accountN
paymentStatusstringThe condition of the account, such as due, paid, in arrearsN
ratingTypestringIndicates whether the account follows a specific payment option such as prepaid or postpaidN
statestringContains the lifecycle state such as: Active, Closed, Suspended and so on.N
accountBalanceobject ArrayBalances linked to the accountN
accountBalance.balanceTypestringType of the balance ; deposit balance, disputed balance, loyalty balance, receivable balance...N
accountBalance.amountobjectBalance amountN
accountBalance.amount.unitstringCurrency (ISO4217 norm uses 3 letters to define the currency)N
accountBalance.amount.valuenumber, floatA positive floating point numberN
accountBalance.validForobject'A period of time, either as a deadline (endDateTime only) a startDateTime only, or bothN
accountBalance.validFor.endDateTimedatetimeEnd of the time period, using IETC-RFC-3339 formatN
accountBalance.validFor.startDateTimedatetimeStart of the time period, using IETC-RFC-3339 format. If you define a start, you must also define an endN
accountBalance.@baseTypestringWhen sub-classing, this defines the super-classN
accountBalance.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
accountBalance.@typestringWhen sub-classing, this defines the sub-class entity nameN
accountRelationshipobject ArraySignificant connection between accounts. For instance an aggregating account for a list of shop branches each having its own billing accountN
accountRelationship.relationshipTypestringType of relationship.N
accountRelationship.accountobject.An account may be a party account or a financial account.N
accountRelationship.account.idstringUnique identifier Id of the EntityDescriptionRef.N
accountRelationship.account.hrefstringUnique reference of the EntityDescriptionRefN
accountRelationship.account.descriptionstringDetailed description of the EntityDescriptionRefN
accountRelationship.account.namestringName of the account.N
accountRelationship.account.@baseTypestringWhen sub-classing, this defines the super-classN
accountRelationship.account.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
accountRelationship.account.@typestringWhen sub-classing, this defines the sub-class entity nameN
accountRelationship.account.@referredTypestringThe actual type of the target instance when needed for disambiguationN
accountRelationship.validForaccountBalance.validFor'A period of time, either as a deadline (endDateTime only) a startDateTime only, or bothN
accountRelationship.@baseTypestringWhen sub-classing, this defines the super-classN
accountRelationship.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
accountRelationship.@typestringWhen sub-classing, this defines the sub-class entity nameN
billStructureobjectThe structure of the bill for party accounts (billing or settlement).N
billStructure.cycleSpecificationobjectAn attachment by value or by reference.N
billStructure.cycleSpecification.idstringUnique identifier of the billing cycle specificationN
billStructure.cycleSpecification.hrefstringReference of the billing cycle specificationN
billStructure.cycleSpecification.billingDateShiftintegerAn offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.N
billStructure.cycleSpecification.billingPeriodstringA billing time period. It can be recurring, for example: week, month, quarter of year, year .N
billStructure.cycleSpecification.chargeDateOffsetintegerAn offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriodN
billStructure.cycleSpecification.creditDateOffsetintegerAn offset of a date through which charges previously received by the billing system will appear on the bill. The offset is expressed as number of days with regard to the start of the BillingPeriodN
billStructure.cycleSpecification.dateShiftintegerAn offset of a billing/settlement date. The offset is expressed as number of days with regard to the start of the billing/settlement period.N
billStructure.cycleSpecification.descriptionstringAn explanation regarding this billing cycle specificationN
billStructure.cycleSpecification.frequencystringFrequency of the billing cycle (monthly for instance)N
billStructure.cycleSpecification.mailingDateOffsetintegerAn offset of a customer bill mailing date. The offset is expressed as number of days with regard to the start of the BillingPeriod.N
billStructure.cycleSpecification.namestringA short descriptive nameN
billStructure.cycleSpecification.paymentDueDateOffsetintegerAn offset of a payment due date. The offset is expressed as number of days with regard to the start of the BillingPeriod.N
billStructure.cycleSpecification.@baseTypestringWhen sub-classing, this defines the super-classN
billStructure.cycleSpecification.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
billStructure.cycleSpecification.@typestringWhen sub-classing, this defines the sub-class entity nameN
billStructure.cycleSpecification.@referredTypestringThe actual type of the target instance when needed for disambiguationN
billStructure.formataccountRelationship.accountAn attachment by value or by reference.N
billStructure.presentationMediaaccountRelationship.accountA list of bill presentation media ref or values
billStructure.@baseTypestringWhen sub-classing, this defines the super-classN
billStructure.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
billStructure.@typestringWhen sub-classing, this defines the sub-class entity nameN
contactobject ArrayAn individual or an organization used as a contact point for a given account and accessed via some contact medium.N
contact.contactNamestringA displayable name for that contactN
contact.contactTypestringType of contact (primary, secondary...)N
contact.partyRoleTypestringIdentifies what kind of party role type is linked to the contact (a account manager...)N
contact.contactMediumobject ArrayIndicates the contact medium that could be used to contact the party.N
contact.contactMedium.mediumTypestringType of the contact medium, such as: email address, telephone number, postal addressN
contact.contactMedium.preferredbooleanIf true, indicates that is the preferred contact mediumN
contact.contactMedium.characteristicobjectAny additional characteristic(s) of this contact mediumN
contact.contactMedium.characteristic.citystringCityN
contact.contactMedium.characteristic.contactTypestringThe type of contact, for example; phone number such as mobile, fixed home, fixed office. postal address such as shipping installationN
contact.contactMedium.characteristic.countrystringN
contact.contactMedium.characteristic.emailAddressstringFull email address in standard formatN
contact.contactMedium.characteristic.faxNumberstringThe fax number of the contactN
contact.contactMedium.characteristic.phoneNumberstringThe primary phone number of the contactN
contact.contactMedium.characteristic.postCodestringPostcodeN
contact.contactMedium.characteristic.socialNetworkIdstringIdentifier as a member of a social networkN
contact.contactMedium.characteristic.stateOrProvincestringState or provinceN
contact.contactMedium.characteristic.street1stringDescribes the streetN
contact.contactMedium.characteristic.street2stringComplementary street descriptionN
contact.contactMedium.characteristic..@baseTypestringWhen sub-classing, this defines the super-classN
contact.contactMedium.characteristic..@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.contactMedium.characteristic..@typestringWhen sub-classing, this defines the sub-class entity nameN
contact.contactMedium.characteristic.geoCodestringGeoCodeN
contact.contactMedium.validForaccountRelationship.validForN
contact.contactMedium.@baseTypestringWhen sub-classing, this defines the super-classN
contact.contactMedium.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.contactMedium.@typestringWhen sub-classing, this defines the sub-class entity nameN
contact.relatedPartyrelatedPartyN
contact.validForaccountRelationship.validForN
contact.@baseTypestringWhen sub-classing, this defines the super-classN
contact.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
contact.@typestringWhen sub-classing, this defines the sub-class entity nameN
creditLimitobjectThe maximum amount of money that may be charged on an accountN
defaultPaymentMethodobjectN
defaultPaymentMethod.idstringUnique identifier Id of the EntityRef.N
defaultPaymentMethod.hrefstringUnique reference of the EntityRefN
defaultPaymentMethod.namestringName of the EntityRef.N
defaultPaymentMethod.@baseTypestringWhen sub-classing, this defines the super-classN
defaultPaymentMethod@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
defaultPaymentMethod.@typestringWhen sub-classing, this defines the sub-class entity nameN
defaultPaymentMethod.@referredTypestringThe actual type of the target instance when needed for disambiguationN
financialAccountobjectAccountReceivable reference. An account of money owed by a party to another entity in exchange for goods or services that have been delivered or used. An account receivable aggregates the amounts of one or more party accounts (billing or settlement) owned by a given party.N
financialAccount.idstringUnique identifier Id of the EntityRef.N
financialAccount.hrefstringUnique reference of the EntityRefN
financialAccount.namestringName of the EntityRef.N
financialAccount.accountBalanceaccountBalancen
financialAccount.@baseTypestringWhen sub-classing, this defines the super-classN
financialAccount@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
financialAccount.@typestringWhen sub-classing, this defines the sub-class entity nameN
financialAccount.@referredTypestringThe actual type of the target instance when needed for disambiguationN
paymentPlanobject ArrayDefines a plan for payment (when a party wants to spread his payments)N
paymentPlan.numberOfPaymentsintegerNumber of payments used to spread the global paymentN
paymentPlan.paymentFrequencystringFrequency of the payments, such as monthly and bimonthlyN
paymentPlan.planTypestringType of payment planN
paymentPlan.priorityintegerPriority of the payment planN
paymentPlan.statusstringStatus of the payment plan (effective, ineffective)N
paymentPlan.paymentMethoddefaultPaymentMethod
paymentPlan.totalAmountaccountBalance.amountAmount paid
paymentPlan.validForaccountRelationship.validFor
paymentPlan.@baseTypestringWhen sub-classing, this defines the super-classN
paymentPlan.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
paymentPlan.@typestringWhen sub-classing, this defines the sub-class entity nameN
characteristicobject ArrayDescribes a given characteristic of an object or entity through a name/value pair.N
characteristic.namestringName of the characteristicN
characteristic.valueTypestringData type of the value of the characteristicN
characteristic.valueanyThe value of the characteristicN
characteristic.@baseTypestringWhen sub-classing, this defines the super-classN
characteristic.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
characteristic.@typestringWhen sub-classing, this defines the sub-class entity nameN
relatedPartyobject ArrayN
relatedParty.idstringUnique identifier Id of the EntityRef.N
relatedParty.hrefstringUnique reference of the EntityRefN
relatedParty.namestringName of the EntityRef.N
relatedParty.rolerole played by the related party
relatedParty.@baseTypestringWhen sub-classing, this defines the super-classN
relatedParty@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
relatedParty.@typestringWhen sub-classing, this defines the sub-class entity nameN
relatedParty.@referredTypestringThe actual type of the target instance when needed for disambiguation
taxExemptionobject ArrayProof of freedom from taxes imposed by a taxing jurisdiction.N
taxExemption.certificateNumberstringIdentifier of a document that shows proof of exemption from taxes for the taxing jurisdiction.N
taxExemption.issuingJurisdictionstringName of the taxing jurisdiction for which taxes are exempt.N
taxExemption.reasonstringReason of the tax exemptionN
taxExemption.validForaccountRelationship.validForN
taxExemption.@baseTypestringWhen sub-classing, this defines the super-classN
taxExemption.@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
taxExemption.@typestringWhen sub-classing, this defines the sub-class entity nameN
@baseTypestringWhen sub-classing, this defines the super-classN
@schemaLocationstringA URI to a JSON-Schema file that defines additional attributes and relationshipsN
@typestringWhen sub-classing, this defines the sub-class entity nameN
fraudFlagbooleanfraud flag which indicates the flagN
recurringFlagbooleanrecurringFlag which indicates the caller frequencyN
pinstringpin of the deviceN
migrationStatusstringindicates the migration status of the customerN
salesforceAccountNumberstringassociated salesforce account numbeN
migrationETAstringETA of the migrationN
bssSourceSystemstringIf(migrationStatus == "In Progress" or "Failed" or "Success") "Anatares" else if("Not Started") ATT else ""N
subscriptionIdstringUnique identifier of the accountN
money.unitstringUnit of moneyN

Administration and data management

In this section you define all the transformations, temporary and final repositories of the data within the method flow.

Transformation Request

nontmf-biz

URL
http://0.0.0.0:9091/nontmf-api/v1/{businessId}/customerMigrationInfo?serviceNumber=XXXXXX
Headers
namevaluedescriptionrequired
X-Correlation-IDstringThis is a unique identifier for the current call chain that can be used to tie together log entries on multiple layers.
Example: 644e1dd7-2a7f-18fb-b8ed-ed78c3F92c2b
O
lobStringPREPAID
O
client_idstringClient Id value for Client Id Enforcement policy. Environment Specific Value.
Eg:6f0ed16a7b494d76b2d60e05bc3b3332
M
client_secretstringClient secret value for Client Id Enforcement policy. Environment Specific Value
Eg: e4CD4D43449846aA9D8Cb9c43fAd324a
M
channelIdstringChannel to identify the business group. Eg:APPO
QueryParameters
Original ParameterMulesofttransformation
serviceNumberattributes.uriParams.id

Services dependencies

This section defines all the connections to the web services and the methods that are used within the method.

nontmf-biz

MethodType
/customerMigrationInfoGET

Reviews